home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 7
/
Aminet 7 - August 1995.iso
/
Aminet
/
comm
/
mebbs
/
cdrid102.lha
/
CDRomID
/
CDRomID.doc
< prev
next >
Wrap
Text File
|
1994-06-22
|
9KB
|
235 lines
********************************************
* *
* CDRomID Version 1.02 *
* *
* Written By, Jason Gouger[M2018] *
* Copyright 1994 All rights reserved *
********************************************
DISCLAIMER:
~~~~~~~~~~
The usual disclaimers concerning computer software apply to this
product. Although this program has been tested extensively for its
accuracy and reliability, the author will accept no liability whatsoever
for damage resulting from the use, misuse, or excessive use of it. The
author also takes no responsibility for data loss or corruption of data
caused by this program! USE IT AT YOUR OWN RISK!
What CDRomID does:
~~~~~~~~~~~~~~~~~
This door will allow user's to directly access a CDRom or any other
device in a "safe" manner. I have set this door up for use with the
AmiNet CDRom, but I am sure it can be used with other CDRom's. The
door allows users to search an Index file which contains a list of the
programs with a Grep type of command. The matches will be returned and
then the user may download the file with the complete filename. It will
check to make sure the user has enough download credits and charge the
account.
Set up:
~~~~~~
Files included in the archive:
1) CDRomID ====> CDRomID Door File
2) CDRomID.CFG ====> Configuration File
3) Intro.txt ====> Graphics file displayed upon door entry
4) Help.txt ====> Graphics help file.
5) CDRomID.doc ====> CDRomID Documentation
Place the above files in a Directory Called CDRomID in the Doors:
Assignment.
***Note*** You need a Grep command to search the INDEX file. I am
using AGrep to search the list. Make sure you place the
EXACT command you would like to be executed in the COMMAND
option. Also, do not forget to include the INDEX filename
to be searched and the options of the Grep command. If
you need a copy of AGrep you can contact my BBS.
How to have several CDRom's online:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To have multiple CDRom's online you should do the following.
1) Duplicate the door with a different name. This can be done
with the Copy or MakeLink command with the following syntax:
Copy DOORS:CDRomID/CDRomID DOORS:CDRomID/AmiNetCD
-OR- (2.04 or greater)
MakeLink DOORS:CDRomID/AmiNetCD DOORS:CDRomID/CDRomID
(This option will *NOT* use disk space) See your AmigaOS
reference for more information)
2) Create a config file with the *SAME* name as the door, except
with the .CFG extension appended. The configuration filename
for the above example:
DOORS:CDRomID/AmiNetCD.CFG
This type of setup allows for the customization of *EACH* CDRom.
Basically the configuration file will have the *SAME* name from which
the CDRomID door was executed from, with the .CFG extension appened.
How to configure the CDRomID.CFG file:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Only lines preceded by the pound sign (#) will be considered as a
configuration entry. Also, there should be *NO SPACES* between the
pound sign and the config entry *AND* the argument must be *FLUSH*
with the equals sign (=).
The configuration file is *CASE SENSITIVE*:
1) COMMAND - Command used to search the INDEX file. The
first %s will be replaced by the Temporary
filename and the second by the search string.
2) TEMPFILE - Temporary filename where the search information
will be returned to. Note, the LineNumber will
be appended to this filename thus, allowing
multiple accesses to this door.
3) FILETEMP - Temporary directory where a requested download
will be stored while the file is being downloaded.
This will speed up file access if multiple user's
are accessing the CDRom. If this option is omited
files will be directly downloaded from the CDRom.
4) CDROMFILES - Location of the files.
5) HEADER - The *COMPLETE* filename of the graphics file
to be displayed before search output.
6) INTRO - The *COMPLETE* filename of the graphics file
to be displayed upon door entry.
7) HELP - The *COMPLETE* filename of the graphics file
to be displayed for help information.
8) FREE - Makes file(s) free. (You can have multiple
FREE entries) The filename will be compared
to the entry's length. So if you had comm/bbs
as free files that had the filename of
comm/bbs/WhatEver would be considered free.
8) ALLFREE - Makes ALL files free.
Example Configuration File:
~~~~~~~~~~~~~~~~~~~~~~~~~~
#COMMAND=DOORS:CDRomID/AGrep >%s -i "%s" AMINET_0294:INDEX
#TEMPFILE=T:CDRomID
#FILETEMP=T:
#CDROMFILES=AMINET_0294:AMINET/
#HEADER=DOORS:CDRomID/Header
#INTRO=DOORS:CDRomID/Intro
#HELP=DOORS:CDRomID/Help
#FREE=INDEX
Things to notice: 1) There are *NO* spaces in the configuration entries.
2) You may need quotes around the %s if your path has
a space in it.
3) You *SHOULD* have quotes around the search string %s.
Usage:
~~~~~
This door is a "MultiRunDoor" type, so to add this door to a menu
you would have something like the following:
Function R
MultiRunDoor "DOORS:CDRomID/CDRomID"
end
-> When executed this door will look for a configuration file called:
DOORS:CDRomID/CDRomID.CFG
With a second CDRom, use an AmiNet CDRom for example you could have the
following:
Function S
MultiRunDoor "DOORS:CDRomID/AmiNetCD"
end
-> When executed this door will look for a configuration file called:
DOORS:CDRomID/AmiNetCD.CFG
Door Usage:
~~~~~~~~~~
The door is pretty self explanatory to operate, but I will go over
a basic outline. When a user enters the door the Intro.[gfx] will be
shown. The user will then be prompted to Search, Download, Display
the Help File, or Quit.
The Search option will prompt for a search string. This string
will be passed directly to your Grep Command. Any back quotes (`) or
double quotations will be converted to a single quote ('). This
secures the user from making any "Escape Commands" to your system.
The download option will prompt the user for the FULL filename.
This filename will be appended to the CDROMFILES configuration
entry. This also secures your system from users downloading on other
devices/assignments.
The Help option will display the graphics help file, and the quit
option will obviously exit the door. The door checks to make sure the
volume is mounted before every access to the CD-Rom is made. If you
were to take the CD-Rom offline, then user will be told that the CD-Rom
has been taken offline and to try again later, and a Volume requestor
will not pop up.
GiftWare:
~~~~~~~~
If you like this program you can make donations to the
following address and make an checks payable to me. Programmers
are inspired by donations!
Jason Gouger
74 White Birch Lane
East Stroudsburg, PA 18301-8339
If you have any questions I can be reached at my bbs.
The Amiga Enterprise 717-223-8269 300-14400 Bps 24 Hours
Comments and Bug Reports:
~~~~~~~~~~~~~~~~~~~~~~~~
Send Comments and Bug reports to:
Jason Gouger - Fidonet 1:268/114
Jason Gouger - MaxNet 90:7170/2
Jason Gouger - Proper Mebbs Echo
JGouger@psu.edu - Internet Address
Other Doors by Me:
~~~~~~~~~~~~~~~~~~~~
UserID [V1.60] - Displays any number of last callers. It is 100%
configurable! Give it a try. You can make you
OWN display output to suit your system. The door
uses text control sequences to insert the last
caller information where ever you choose. Try it
out!
MQwkID [V0.01] - Allow user's the opportunity to download
messages from MULTIPLE message areas for offline
reading and response. The user's will be able to
read the mail with any QWK compatible reader. This
door also severs as a tosser for the reply packets.
History:
~~~~~~~
1.00 ==> First Release
1.01 ==> The proper temporary file was not being created.
1.02 ==> Added support for multiple CDRom's
Added the ability for a temporary download storage directory.
Bugs: A User's account will be charged for a download even if it
is *NOT* sucessful!!! This includes aborted downloads. This
will be fixed as soon as the SendFile() function returns if it
is sucessful :)